In this section, you are required to fill  in the basics of the devices. Mandatory fields are marked with asterisks as shown below.

For these fields, we explain one by one as follows:

Name. This is a mandatory field, and you need to give a name to the device that you are planting in. For planted devices, you can search for them by names (see detail about search here), so please give them proper names. But, names do not need to be unique.

Type. This is mandatory, and the NUCLEUS comes with several built-in device types; you can select one from the drop-down list. Furthermore, you can develop customized device types, but this topic exceeds the scope of this user guide.

Tag. This is optional, and you can choose tags in the drop-down list for the device; or, you can type in and press 'Enter' key to introduce new tags for the device. The tags of a device can be used when you intend to filter out devices (not search). 

Placemark. The placemark represents the device on the site, and you can click the 'Edit' button to choose one for the device. NUCLEUS provides a library of built-in 2D icons and 3D models; in addition, you are also allowed to upload your local files into NUCLEUS as your device's icon. Upon your selecting of an icon, it will move around with your mouse, showing the 3D coordinate of the mouse point as moving; you can click to place the icon in the 3D view.

Position. If you have your device's icon fixed in the site and want to relocate it, this field allows you to relocate it by clicking the "Edit" button. After the clicking, you can move around to deice the new place for the icon and then double-click to fix. Alternatively, you can provide the 3D coordinate to accurately place the icon at a point in the site. If you want to query the coordinate of a location in the site, the coordinate picker can be helpful.

Block. This is optional, and you can choose which block the device belongs to in the drop-down list. 

In the section of "Advanced", you can define the global view, volume effect, and line effect of the device, as shown below. These fields are optional for planting the device, but they can benefit if they are properly defined.

       

To define the global view, you should:

1. click on the  button;
2. adjust the 3D view to best visualize the device in the site, using the orbit or first person navigation methods ;
3. click the  button to save global view.

To define the volume, you should:

1. click the  button;
2. click on the ground to set the corners of the volume;
3. move the  button (alternatively, you can directly type in a value into the text box) to define the height of the volume;
4. click the  button to save the volume.      

In the illustration below, the device's volume is used to represent the room's space. First, double-click the four corners of the room to specify a rectangle. Then, change the height to a reasonable level. In addition, you can customize the color of the volume in the drop-down list (we picked pink in the example below).

 

                    

To define the line effect, you should:

1. click the  button;
2. click to fix a point at a time, and the point's coordinate will be displayed to you;
3. you can repeat the step 2 to create as many points as you want;
4. click the  button to stop adding point and create the line.

During the phrase of adding points, you can click the  to roll back the immediately added point, and you can continually roll back till the first point. For a created line, you can click  to enable the editing again.

Concepts